home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / tcl / tcl67.lha / tcl6.7 / doc / CrtInterp.3 < prev    next >
Text File  |  1993-01-31  |  2KB  |  51 lines
  1. '\"
  2. '\" Copyright 1989 Regents of the University of California
  3. '\" Permission to use, copy, modify, and distribute this
  4. '\" documentation for any purpose and without fee is hereby
  5. '\" granted, provided that this notice appears in all copies.
  6. '\" The University of California makes no representations about
  7. '\" the suitability of this material for any purpose.  It is
  8. '\" provided "as is" without express or implied warranty.
  9. '\" 
  10. '\" $Header: /user6/ouster/tcl/man/RCS/CrtInterp.3,v 1.5 93/01/31 15:35:30 ouster Exp $ SPRITE (Berkeley)
  11. '\" 
  12. .so man.macros
  13. .HS Tcl_CreateInterp tcl
  14. .BS
  15. .SH NAME
  16. Tcl_CreateInterp, Tcl_DeleteInterp \- create and delete Tcl command interpreters
  17. .SH SYNOPSIS
  18. .nf
  19. \fB#include <tcl.h>\fR
  20. .sp
  21. Tcl_Interp *
  22. \fBTcl_CreateInterp\fR()
  23. .sp
  24. \fBTcl_DeleteInterp\fR(\fIinterp\fR)
  25. .SH ARGUMENTS
  26. .AS Tcl_Interp *interp
  27. .AP Tcl_Interp *interp in
  28. Token for interpreter to be destroyed.
  29. .BE
  30.  
  31. .SH DESCRIPTION
  32. .PP
  33. \fBTcl_CreateInterp\fR creates a new interpreter structure and returns
  34. a token for it.  The token is required in calls to most other Tcl
  35. procedures, such as \fBTcl_CreateCommand\fR, \fBTcl_Eval\fR, and
  36. \fBTcl_DeleteInterp\fR.
  37. Clients are only allowed to access a few of the fields of
  38. Tcl_Interp structures;  see the Tcl_Interp
  39. and \fBTcl_CreateCommand\fR man pages for details.
  40. The new interpreter is initialized with no defined variables and only
  41. the built-in Tcl commands.  To bind in additional commands, call
  42. \fBTcl_CreateCommand\fR.
  43. .PP
  44. \fBTcl_DeleteInterp\fR destroys a command interpreter and releases all of
  45. the resources associated with it, including variables, procedures,
  46. and application-specific command bindings.  After \fBTcl_DeleteInterp\fR
  47. returns the caller should never again use the \fIinterp\fR token.
  48.  
  49. .SH KEYWORDS
  50. command, create, delete, interpreter
  51.